home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / acctsh.z / acctsh
Encoding:
Text File  |  2002-10-03  |  15.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaaccccccccttttsssshhhh((((1111MMMM))))                                                          aaaaccccccccttttsssshhhh((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _aaaa_cccc_cccc_tttt_ssss_hhhh:  _cccc_hhhh_aaaa_rrrr_gggg_eeee_ffff_eeee_eeee, _cccc_kkkk_pppp_aaaa_cccc_cccc_tttt, _llll_aaaa_ssss_tttt_llll_oooo_gggg_iiii_nnnn, _mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt, _nnnn_uuuu_llll_llll_aaaa_dddd_mmmm, _pppp_rrrr_cccc_tttt_mmmm_pppp,
  10.      _pppp_rrrr_dddd_aaaa_iiii_llll_yyyy, _pppp_rrrr_tttt_aaaa_cccc_cccc_tttt, _ssss_hhhh_uuuu_tttt_aaaa_cccc_cccc_tttt, _ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp, _tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt - shell procedures for
  11.      accounting
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_hhhh_aaaa_rrrr_gggg_eeee_ffff_eeee_eeee _l_o_g_i_n-_n_a_m_e _n_u_m_b_e_r
  15.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_kkkk_pppp_aaaa_cccc_cccc_tttt [_b_l_o_c_k_s]
  16.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_llll_aaaa_ssss_tttt_llll_oooo_gggg_iiii_nnnn _[[[[_----_cccc _i_n_f_i_l_e]
  17.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt _n_u_m_b_e_r
  18.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_nnnn_uuuu_llll_llll_aaaa_dddd_mmmm _f_i_l_e
  19.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_pppp_rrrr_cccc_tttt_mmmm_pppp
  20.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_pppp_rrrr_dddd_aaaa_iiii_llll_yyyy [_----_llll] [_----_cccc] [_m_m_d_d]
  21.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_pppp_rrrr_tttt_aaaa_cccc_cccc_tttt _f_i_l_e ["_h_e_a_d_i_n_g"]
  22.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_ssss_hhhh_uuuu_tttt_aaaa_cccc_cccc_tttt ["_r_e_a_s_o_n"]
  23.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp
  24.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt _oooo_nnnn | _oooo_ffff_ffff | _ssss_wwww_iiii_tttt_cccc_hhhh
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      _cccc_hhhh_aaaa_rrrr_gggg_eeee_ffff_eeee_eeee can be invoked to charge a _n_u_m_b_e_r of units to _l_o_g_i_n-_n_a_m_e.  A
  28.      record is written to _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_ffff_eeee_eeee, to be merged with other accounting
  29.      records by _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt.
  30.  
  31.      _cccc_kkkk_pppp_aaaa_cccc_cccc_tttt should be initiated via _cccc_rrrr_oooo_nnnn(1M) to periodically check the size
  32.      of _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_pppp_aaaa_cccc_cccc_tttt.  If the size exceeds _b_l_o_c_k_s, 1000 by default, _tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt
  33.      is invoked with argument _s_w_i_t_c_h.  If the number of free disk blocks in
  34.      the _////_vvvv_aaaa_rrrr filesystem falls below 500, _cccc_kkkk_pppp_aaaa_cccc_cccc_tttt automatically turns off the
  35.      collection of process accounting records via the _o_f_f argument to
  36.      _tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt.  When at least 500 blocks are restored, the accounting is
  37.      activated again on the next invocation of _cccc_kkkk_pppp_aaaa_cccc_cccc_tttt.  This feature is
  38.      sensitive to the frequency at which _cccc_kkkk_pppp_aaaa_cccc_cccc_tttt is executed, usually by _cccc_rrrr_oooo_nnnn.
  39.  
  40.      The _llll_aaaa_ssss_tttt_llll_oooo_gggg_iiii_nnnn command records the last date on which each user logged in.
  41.      It is invoked by both the standard UNIX System V accounting and
  42.      Comprehensive System Accounting (CSA) packages as part of the daily
  43.      accounting run.  By default, lastlogin processes the
  44.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_tttt_aaaa_cccc_cccc_tttt_...._MMMM_MMMM_DDDD_DDDD file, and it updates the
  45.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_llll_oooo_gggg_iiii_nnnn_llll_oooo_gggg file.  _cccc_tttt_aaaa_cccc_cccc_tttt_...._MMMM_MMMM_DDDD_DDDD is a standard UNIX System V
  46.      accounting total accounting file in tacct format.
  47.  
  48.      The _----_cccc _i_n_f_i_l_e option specifies that _llll_aaaa_ssss_tttt_llll_oooo_gggg_iiii_nnnn should process _i_n_f_i_l_e,
  49.      which is a consolidated accounting file in cacct format.  When the _----_cccc
  50.      option is specified, _llll_aaaa_ssss_tttt_llll_oooo_gggg_iiii_nnnn updates the _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa_////_llll_oooo_gggg_iiii_nnnn_llll_oooo_gggg
  51.      file.
  52.  
  53.      _mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt should be invoked once each month or each accounting period.
  54.      _n_u_m_b_e_r indicates which month or period it is.  If _n_u_m_b_e_r is not given, it
  55.      defaults to the current month (01-12).  This default is useful if _mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt
  56.      is to execute via _cccc_rrrr_oooo_nnnn(1M) on the first day of each month.  _mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt
  57.      creates summary files in _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ffff_iiii_ssss_cccc_aaaa_llll and restarts the summary
  58.      files in _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaccccccccttttsssshhhh((((1111MMMM))))                                                          aaaaccccccccttttsssshhhh((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      _nnnn_uuuu_llll_llll_aaaa_dddd_mmmm creates _f_i_l_e with mode 664 and ensures that owner and group are
  75.      _aaaa_dddd_mmmm.  It is called by various accounting shell procedures.
  76.  
  77.      _pppp_rrrr_cccc_tttt_mmmm_pppp can be used to print the session record file (normally
  78.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_tttt_mmmm_pppp is created by _aaaa_cccc_cccc_tttt_cccc_oooo_nnnn_1111 (see _aaaa_cccc_cccc_tttt_cccc_oooo_nnnn(1M)).
  79.  
  80.      _pppp_rrrr_dddd_aaaa_iiii_llll_yyyy is invoked by _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt to format a report of the previous day's
  81.      accounting data.  The report resides in _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_rrrr_pppp_rrrr_tttt_////_mmmm_mmmm_dddd_dddd where
  82.      _m_m_d_d is the month and day of the report.  The current daily accounting
  83.      reports can be printed by typing _pppp_rrrr_dddd_aaaa_iiii_llll_yyyy.  Previous days' accounting
  84.      reports can be printed by using the _m_m_d_d option and specifying the exact
  85.      report date desired.  The _----_llll flag prints a report of exceptional usage by
  86.      login ID for the specified date.  Previous daily reports are cleaned up
  87.      and therefore inaccessible after each invocation of _mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt.  The _----_cccc flag
  88.      prints a report of exceptional resource usage by command and can be used
  89.      on the current day's accounting data only.
  90.  
  91.      _pppp_rrrr_tttt_aaaa_cccc_cccc_tttt can be used to format and print any total accounting (_tttt_aaaa_cccc_cccc_tttt)
  92.      file.
  93.  
  94.      _ssss_hhhh_uuuu_tttt_aaaa_cccc_cccc_tttt is invoked during a system shutdown to turn process accounting
  95.      off and append a reason record to _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_wwww_tttt_mmmm_pppp.
  96.  
  97.      _ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp can be invoked when the system is brought to a multiuser state to
  98.      turn process accounting on.
  99.  
  100.      _tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt is an interface to _aaaa_cccc_cccc_tttt_oooo_nnnn (see _aaaa_cccc_cccc_tttt(1M)) to turn process
  101.      accounting _oooo_nnnn or _oooo_ffff_ffff.  The _ssss_wwww_iiii_tttt_cccc_hhhh argument moves the current
  102.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_pppp_aaaa_cccc_cccc_tttt to the next free name in _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_pppp_aaaa_cccc_cccc_tttt_i_n_c_r (where _i_n_c_r is
  103.      a number starting with _1111 and incrementing by one for each additional
  104.      _pppp_aaaa_cccc_cccc_tttt file), then turns accounting back on again.  This procedure is
  105.      called by _cccc_kkkk_pppp_aaaa_cccc_cccc_tttt and thus can be taken care of by the _cccc_rrrr_oooo_nnnn and used to
  106.      keep _pppp_aaaa_cccc_cccc_tttt to a reasonable size.  _ssss_hhhh_uuuu_tttt_aaaa_cccc_cccc_tttt uses _tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt to stop process
  107.      accounting.  _ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp uses _tttt_uuuu_rrrr_nnnn_aaaa_cccc_cccc_tttt to start process accounting.
  108.  
  109. FFFFIIIILLLLEEEESSSS
  110.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_ffff_eeee_eeee               accumulator for fees
  111.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_pppp_aaaa_cccc_cccc_tttt             current file for per-process accounting
  112.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_pppp_aaaa_cccc_cccc_tttt_i_n_c_r         used if _pppp_aaaa_cccc_cccc_tttt gets large and during execution
  113.                                 of daily accounting procedure
  114.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_wwww_tttt_mmmm_pppp              login/logoff summary
  115.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_pppp_tttt_eeee_llll_uuuu_ssss_...._aaaa_wwww_kkkk   contains the limits for exceptional usage by
  116.                                 login ID
  117.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_pppp_tttt_eeee_cccc_mmmm_ssss_...._aaaa_wwww_kkkk   contains the limits for exceptional usage by
  118.                                 command name
  119.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee         working directory
  120.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt              holds all accounting commands in section 1M
  121.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm          summary directory contains information for
  122.                                 _mmmm_oooo_nnnn_aaaa_cccc_cccc_tttt
  123.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa      summary directory contains information for CSA
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaaccccccccttttsssshhhh((((1111MMMM))))                                                          aaaaccccccccttttsssshhhh((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ffff_iiii_ssss_cccc_aaaa_llll_////_cccc_ssss_aaaa   fiscal reports directory
  141.  
  142. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  143.      acct(1M), acctcms(1M), acctcom(1), acctcon(1M), acctmerg(1M),
  144.      acctprc(1M), cron(1M), csarun(1M), dodisk(1M), fwtmp(1M), runacct(1M),
  145.      acct(2), acct(4), utmp(4).
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.